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INTRODUCTION 



The io_cal I cowman a currently provides complete facilities 
at command level for performing all possible operations on a 
single I/O switch, with the exception of iox_$control requiring 
an information pointer. As such, it provides an extremely useful 
tool for setting up user program input/output switches, and for 
debugging programs and I/O modules* 

The major facility it does not provide is a copy facility. 
There is a need to copy from one switch to another, either until 
the input switch exhausts the input source* or until a certain 
number of read/write operations have been performed. 

A switch-to-sw itch copy facility would support file-to-tape 
operations through any of the tape I/O modules, fi !e-to-disk 
operations through the disk I/O module, and special -purpose 
file-to-printer, card reader-to-file, and file-to-card punch 
operations. As such, it would be a useful toot for debugging, 
and for quick copy operations between various media. 



See the attached draft MPM documentation. 



CRITICISM 

The above interface can copy from or to any type of file 
except for keyed sequential files* One can argue that these are 
only supported by the storage system (vfile_) currently, and can 
be copied with the copy command. 

An alternate proposal would use a -keyed control argument to 
signify that both the input and output files were keyed 
sequential. The input file would be opened for 
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keyed_sequential_input and the output file for 

keyed_sequential_outout • Records and their keys could then be 

read with read_key/read_record operations* and written with 
see k_key/ wr i te — record oper at i ons. 

Given the United use of keyed files and the availability of 
the copy command, It is probably unnecessary for f i le_copy to 
provide this level of support* Note that the interface docs 
permit a keyed sequential Input file to be read and copied in a 
sequential manner* 

Nhile the Interface can copy unstructured files* the 
record_stream_ I/O module is required as an Intermediary* 
Although the transformation function could conceivably be 
Integrated with flle_copy, the record_stream_ I/O module was 
specifically designed to effect this type of conversion, and 
there is no need to duplicate Its function within the file_copy 
command* 



f i I e.copy 



f i I e_copy 



JBai&S* file.copy, fc 



This connand copies records from an Input file to an output 
file. The input and output file types must be sequential. (See 
Unstructured Files end Keyed Files* below, for an explanation of 
hOM these types of files may be copied*) The input file nay be 
copied either partially* or in its entirety. 



file. copy input.spec output. spec -control.args- 

where* 



i. input_spec specifies the input file fron which records 

are read. It way be either an I/O switch 
nana* or an attach description. (See Notes* 
below* ) 



-input.switch switchnane 
-isw switchnane 

specifies the input file by means of an 
already attached I/O switch name, switchnane. 

-input.fi te XXX 

-If XXX specifies the input file by neans of an 

attach description* XXX. 

2. output.spec specifies the output file to which these 

records are written. It nay be either an I/O 
switch nane« or an attach description. (See 
Notes* below.) 

-output.swltch switch, name 
-osw switchnane 

specifies the output file by neans of an 
already attached I/O switch nane* switchnane. 

-output.fi le XXX 

-of XXX specifies the output file by neans of an 

attach description* XXX. 

3. control.args may be one or nore of the following optional 

control argunents (see Notes* below) t 



-fron I 

-fn I specifies that records are copied beginning 

with the Ith record of the input file. I 

must be a positive integer. The default is 
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to begin copying with the "next record*. 
ISee Notes* below.) 

-to J specifies that copying is performed until the 

Jth record has been copied* or the input file 
exhausted* whichever occurs first* If this 
option is specified* -from «ust also be 
specified. J must be a positive integer* 
greater than or equal to I* 

-count N 

-ct N specifies that copying is performed until N 

records have been copied* or the input file 
exhausted* whichever occurs first* N aust be 
a positive integer* 

-all* -a specifies that records are copied until the 

input file is exhausted* This is the 
default* 

-brief* -bf specifies that the message indicating the 
number of records actually copied is to be 
suppressed* 

-long* -Ig specifies that a message indicating the 
number of records actual ly copied is to be 
printed* This is the default* 



Unstructured Fit as 

flle_copy operates by performing record I/O on structured 
files* If it is desired to copy from/to an unstructured file* 
the record_stream_ I/O module may used* e*g*t 

file_copy -If record_stream_ -target vfile_ pathname -osw OUT 

The effect is to take lines from the file specified by pathname 
via vfile_* transform them into records Jtia record_stream_* and 
then copy them to the I/O switch named OUT* 



Keved Files 

file_copy processes only the sequential type of structured 
file* The copy command may be used to copy Indexed sequential 
storage system files preserving keys* CSee the MPM write-up of 
the copy command*) However* file_copy may be used to copy an 
Indexed sequential input file in a sequential manner 
I disregarding keys!* Note that the output file type is 
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no/no /7c 
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sequential* not indexed sequential* 



Notes 

If either the input or output specification is an attach 
description* it is used to attach an unique I y-named I/O switch to 
the file. The switch Is opened for sequentia!_input or 
sequent ial_output* the copy performed* and then closed and 
detached. If an attach description contains any of the control 
arguments used by file_copy* then it must be quoted* 
Alternately* an I/O snitch aay be attached using the io_call 
coanand* and the file specified by means of the I/O switch name. 
ISee the HPH write-up of the io_call coanand.) 

If the input file is specified by an I/O switch name and the 
switch Is not open* fHe_copy opens It for sequent ia l_ input * 
performs the copy* and closes it* If the switch is already open 
when file_copy is invoked* it is not closed after the copy has 
been performed; the file is left positioned immediately after 
the last record copied* 

If the -from control argument is not used to specify an 
absolute starting position within the input file* copying begins 
with the "next record"* If the I/O switch is opened by 
file_copy* the next record is the first record of the file; 
otherwise* the next record is that record at which the file is 
positioned when f i I e_copy is invoked* 

If the output file is specified by an I/O switch name and 
the switch is not open* file_copy opens It for sequential.output* 
performs the copy* and closes it. If the switch is already open 
when file_copy is invoked* it is not closed after the copy has 
been performed; the file is left positioned immediately after 
the last record copied* 

The -brief and -long control arguments are mutually 
exclusive* The copy count message appears as follows! 

file_copyi 3*»5 records copied* (EOI) 

The appearance of EOI (£nd £f Information) indicates that the 
last record copied was the last record in the input file* 

The -to* -count* and -all control arguments are mutually 
exc lusive* 
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